Kapitel 25 Referenz
Kein Buch ist so schlecht, dass es nicht auch irgendwie nützlich sein könnte.
- Plinius Junior
 |
In diesem abschließenden Referenzkapitel werden nur die wichtigsten Browser betrachtet. Netscape 6 (basierend auf der »Gecko«-Engine) wurde nicht explizit aufgenommen, denn die einzigen Änderungen sind DOM-bezogen, und dadurch (noch) nicht relevant, solange der Browser noch keinen stabilen Stand erreicht hat. |
Seit dem Netscape Navigator 3 bzw. Internet Explorer 4 kennt jedes Objekt die Methode toString(), welche eine Zeichenkettenrepräsentation des Objekts wiedergibt. So wird beispielsweise ein wahrer Boolescher Wert in "true" umgewandelt.
Die Tabelle 25.1 gibt wieder, welche Browser welche JavaScript-Versionen unterstützen. Sofern es in der Implementierung Abweichungen gibt (ein Objekt wird etwa erst ab JavaScript 1.1 unterstützt, aber auch vom Internet Explorer 3), so wird das bei der Beschreibung des Objekts angegeben.
Tabelle 25.1 JavaScript-Versionen und die jeweiligen Browser
| JavaScript-Version |
ab ... |
ab ... |
| 1.0 |
Netscape Navigator 2 |
Internet Explorer 3 |
| 1.1 |
Netscape Navigator 3 |
Internet Explorer 4 |
| 1.2 |
Netscape Navigator 4 |
Internet Explorer 4 (in Teilen); Internet Explorer 5 (fast vollständig) |
| 1.3 |
Netscape Navigator 4.06 |
Internet Explorer 5 |
| 1.5 |
Netscape 6 |
/ |
Der Internet Explorer 5 hat nur wenige Methoden oder Eigenschaften des Netscape Navigator 4 übernommen; die meisten neuen Netscape-Funktionen, die im Internet Explorer 5 vorhanden sind, waren schon in Version 4 implementiert.
Bei der Auflistung der Methoden wird nur dann eine Syntax angegeben, wenn die Methode Parameter akzeptiert. Eckige Klammern in der Parameterliste stehen für optionale Werte.
Bei jedem Objekt ist anfangs angegeben, ab welcher JavaScript-Version es unterstützt wird. Bei den Methoden und Eigenschaften ist nur dann eine JavaScript-/Browser-Version angegeben, wenn diese sich von der vorherigen Version unterscheidet.
Tabelle 25.2 enthält die Event-Handler, die von JavaScript erkannt werden.
Tabelle 25.2 Event-Handler
| Event-Handler |
Beschreibung |
| onAbort |
Abbruch beim Laden (z. B. Grafik) |
| onBlur |
Verlust des Fokus |
| onClick |
Anklicken mit der Maus |
| onDragDrop |
Drag&Drop-Operation |
| onError |
JavaScript-Fehler |
| onFocus |
Erhalt des Fokus |
| onKeyDown |
Niederdrücken einer Taste |
| onKeyPress |
Tastendruck |
| onKeyUp |
Loslassen einer Taste |
| onLoad |
Vollständiges Laden |
| onMouseDown |
Niederdrücken einer Maustaste |
| onMouseOut |
Mauszeiger verläßt Objekt |
| onMouseOver |
Mauszeiger über Objekt |
| onMouseUp |
Loslassen einer Maustaste |
| onMove |
Mausbewegung |
| onReset |
Formular wird zurückgesetzt |
| onResize |
Fenstergröße wird verändert |
| onSelect |
Element wird ausgewählt |
| onSubmit |
Formular wird abgeschickt |
| onUnload |
Dokument wird »entladen« (neues Dokument wird geladen, Fenster wird geschlossen) |
Die aktuellen Versionen der Dokumentationen gibt es online bei den jeweiligen Browserherstellern:
Netscape:
http://devedge.netscape.com/docs/manuals/javascript.html
Microsoft:
http://msdn.microsoft.com/scripting/jscript/techinfo/jsdocs.html
http://msdn.microsoft.com/workshop/author/
25.1 Das Anchor-Objekt  
JS 1.0
Ab JavaScript 1.0
Das Anchor-Objekt, eine Eigenschaft des document-Objekts, ist ein Array, das alle Textmarken innerhalb eines Dokuments enthält.
25.1.1 Allgemeines 
HTML-Tag: <A NAME="Name">
Mit folgendem Beispielcode werden alle Linkziele im Dokument ausgegeben:
<HTML>
<HEAD>
<SCRIPT LANUGAGE="JavaScript"><!--
function zeige_links(){
var text = ""
for (var i=0; i<document.anchors[].length)
text += i + ": " + document.anchors[i] + "\n"
alert(text)
}
//--></SCRIPT>
</HEAD>
<BODY onLoad="zeige_links()">
...
</BODY>
</HTML>
25.1.2 Eigenschaften
name
JS 1.2
NAME-Attribut der Textmarke; ab JavaScript 1.2; nur Schreibzugriff
text
JS 1.2
Text der Textmarke; ab JavaScript 1.2; nur Schreibzugriff
x
JS 1.2
x-Koordinate der linken oberen Ecke der Textmarke; ab JavaScript 1.2; nur Schreibzugriff
y
JS 1.2
y-Koordinate der linken oberen Ecke der Textmarke; ab JavaScript 1.2; nur Schreibzugriff
Im folgenden Beispiel werden die Textmarken-Eigenschaften ausgegeben:
<HTML>
<HEAD>
<SCRIPT LANUGAGE="JavaScript"><!--
function zeige_eigenschaften(){
var text = ""
text += "name: "+document.anchors[0].name
text += "text: "+document.anchors[0].text
text += "x: "+document.anchors[0].x
text += "y: "+document.anchors[0].y
alert(text)
}
//--></SCRIPT>
</HEAD>
<BODY onLoad="zeige_eigenschaften()">
<A NAME="Textmarke">Galileo Press</A>
</BODY>
</HTML>
25.2 Das Array-Objekt
JS 1.1
Ab JavaScript 1.1
In einem Array werden mehrere Daten abgespeichert und über einen nummerischen Index verwaltet. Beim Netscape Navigator 2 ist das Array-Objekt nur unter UNIX implementiert, beim Internet Explorer 3 nur unvollständig. Die meisten Methoden können aber nachgeahmt werden. Genauere Informationen dazu finden Sie im Kapitel »Arrays«.
25.2.1 Allgemeines
new Array()
new Array(Größe)
new Array(Element1, Element2, ..., ElementN)
Größe - (Anfängliche) Anzahl der Elemente im Array. Diese Methode funktioniert ab JavaScript 1.2 nicht mehr, dort wird jeder Parameter als Array-Element behandelt.
Element1, Element2, ..., ElementN - Anfängliche Elemente im Array
Auf die einzelnen Elemente des Arrays wird über den entsprechenden Index (er beginnt bei 0) zugegriffen: arrayname[3] greift auf das vierte Element zu.
25.2.2 Methoden
concat
JS 1.2
Verbindet zwei oder mehr Arrays; ab JavaScript 1.2.
concat(Array1, Array2, ..., ArrayN)
Array1, Array2, ..., ArrayN - Ein oder mehrere Arrays
Die Methode liefert ein neues Array zurück, das aus den Elementen des aufrufenden Arrays und den als Parameter übergebenen Arrays besteht.
var arr1 = new Array(1, 2, 3)
var conc = arr1.concat(new Array("4", "5", "6"))
//conc enthält nun die Elemente 1, 2, 3, "4", "5", "6")
join
Wandelt die Array-Elemente in eine Zeichenkette um; der Separator kann als Parameter übergeben werden.
join(Separator)
Separator - Trennzeichen
var arr = new Array(1, 2, 3)
var joinarr = arr.join("-")
//joinarr hat nun den Wert "1-2-3"
pop
JS 1.2
Das letzte Element des Arrays wird entfernt und zurückgegeben; ab JavaScript 1.2.
pop()
var arr = new Array(1, 2, 3)
var elem = arr.pop()
//arr hat nun die Elemente 1 und 2; elem den Wert 3
push
JS 1.2/1.3
Fügt ein oder mehrere Zeichen hinten an das Array an. Die Anzahl der Elemente nach dieser Operation (JavaScript 1.3) bzw. das zuletzt hinzugefügte Element (JavaScript 1.2) wird zurückgegeben.
push(Element1, Element2, ..., ElementN)
Element1, Element2, ..., ElementN - Neue Array-Elemente
var arr = new Array(1, 2, 3)
var newlen = arr.push(2, 1)
//arr hat nun die Elemente 1, 2, 3, 2 ,1;
//newlen den Wert 5 (JS1.3) bzw. 1 (JS1.2)
reverse
Kehrt die Reihenfolge der Elemente im Array um.
reverse()
var arr = new Array(1, 2, 3)
var revarr = arr.reverse()
//revarr hat nun die Elemente 3, 2, 1
shift
JS 1.2
Das erste Element des Arrays wird entfernt und zurückgegeben; ab JavaScript 1.2.
shift()
var arr = new Array(1, 2, 3)
var elem = arr.shift()
//arr hat nun die Elemente 2, 3; elem hat den Wert 1
slice
JS 1.2
Entfernt Elemente aus einem Array und liefert die restlichen Elemente als Array zurück. Das ursprüngliche Array wird nicht geändert; ab JavaScript 1.2.
slice(Start[, Ende])
Start - Index des ersten Elements, das entfernt werden soll
Ende - Index des ersten Elements, das nicht mehr entfernt werden soll. Fehlt diese Angabe, so werden alle Elemente ab Start entfernt; ist der Parameter negativ, so wird von hinten gezählt.
var arr1 = new Array(1, 2, 3, 4, 5)
var arr1_1 = arr1.slice(1, 3)
//arr1_1 hat nun die Elemente 1, 4, 5
var arr2 = new Array(1, 2, 3, 4, 5)
var arr2_1 = arr2.slice(3)
//arr2_1 hat nun die Elemente 1, 2, 3
var arr3 = new Array(1, 2, 3, 4, 5)
var arr3_1 = arr3.slice(0, -2)
//arr3_1 hat nun die Elemente 1, 2
sort
JS 1.2
Sortiert die Elemente des Arrays alphanumerisch. Ab JavaScript 1.2 kann eine Sortierfunktion angegeben werden (vgl. Kapitel »Arrays«).
sort([Sortierfunktion])
Sortierfunktion - Funktion, über die man die Reihenfolge der Elemente bestimmen kann, indem bei je zwei Werten zurückgegeben wird, welches Element größer ist.
var arr1 = new Array(5, 3, 11)
arr1.sort()
//arr1 hat nun die Elemente 11, 3, 5 (alphanumerisch)
function numsort(a, b){ return a-b }
var arr2 = new Array(5, 3, 11)
arr2.sort(numsort)
//arr2 hat nun die Elemente 3, 5, 11
splice
JS 1.2
Entfernt Elemente aus einem Array und fügt neue Elemente an (optional); ab JavaScript 1.2; Rückgabewert ab JavaScript 1.3 die entfernten Elemente.
splice(Start, Wie viele[, Element1, Element2, ..., ElementN])
Start - Index des ersten Elements, das entfernt werden soll.
Wie viele - Anzahl der Elemente, die ab Start entfernt werden sollen.
Element1, Element2, ..., ElementN - (Optionale) Elemente, die hinten an das Array angefügt werden sollen.
var arr1 = new Array(1, 2, 3, 4, 5)
var splicearr = arr1.splice(1, 2, 3, 4, 5)
//splicearr hat nun die Elemente 1, 4, 5, 3, 4, 5
unshift
JS 1.2
Fügt ein oder mehr Elemente vorn an das Array an und gibt die neue Länge des Arrays zurück; ab JavaScript 1.2.
var arr = new Array(1, 2, 3)
var unsh = arr.unshift(4, 5)
//arr hat nun die Elemente 4, 5, 1, 2, 3; unsh den Wert 5
25.2.3 Eigenschaften
length
Anzahl der Elemente im Array, wird automatisch angepaßt.
var arr = new Aray(1, 2, 3, 4, 5)
//arr.length hat nun den Wert 5
25.3 Das Button-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird eine Schaltfläche in einem Formular in JavaScript abgebildet; das Objekt ist ein Element des Form-Objekts.
25.3.1 Allgemeines
HTML-Tag: <INPUT TYPE="BUTTON">
document.forms[Index].elements[index]
document.FormularName.ButtonName
Index - Index im jeweiligen Array
ButtonName - NAME-Attribut der Schaltfläche
25.3.2 Event-Handler
onBlur (JS1.1)
onFocus (JS1.1)
onClick
onMouseDown (JS1.2)
onMouseUp (JS1.2)
25.3.3 Methoden
blur
JS 1.1
Entfernt den Fokus von der Schaltfläche; ab JavaScript 1.1.
click
JS 1.1
Simuliert das Anklicken der Schaltfläche.
focus
Gibt der Schaltfläche den Fokus; ab JavaScript 1.1.
25.3.4 Eigenschaften
form
Referenz auf das Formular, das die Schaltfläche enthält.
name
NAME-Attribut der Schaltfläche.
type
JS 1.1
Zeichenkette mit dem Wert "button"; ab JavaScript 1.1.
value
VALUE-Attribut der Schaltfläche.
25.4 Das Checkbox-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird eine Schaltfläche in einem Formular in JavaScript abgebildet; das Objekt ist ein Element des Form-Objekts.
25.4.1 Allgemeines
HTML-Tag: <INPUT TYPE="CHECKBOX">
document.forms[Index].elements[Index]
document.FormularName.CheckboxName
Index - Index im jeweiligen Array
CheckboxName - NAME-Attribut der Checkbox
25.4.2 Event-Handler
onBlur (JS1.1)
onFocus (JS1.1)
onClick
25.4.3 Methoden
blur
Entfernt den Fokus von der Checkbox.
click
Simuliert das Anklicken der Checkbox.
focus
Gibt der Checkbox den Fokus.
25.4.4 Eigenschaften
checked
Der Wert ist true, wenn die Checkbox angekreuzt ist, ansonsten false.
defaultChecked
Der Wert ist true, wenn die Checkbox HTML-mäßig angekreuzt ist (durch Parameter CHECKED), ansonsten false.
form
Referenz auf das Formular, das die Checkbox enthält.
name
NAME-Attribut der Checkbox
type
JS 1.1
Zeichenkette mit dem Wert "checkbox"; ab JavaScript 1.1.
value
VALUE-Attribut der Checkbox; wenn sie nicht gesetzt ist, ist der Wert "on".
25.5 Das Date-Objekt
JS 1.0
Ab JavaScript 1.0
JS 1.3
In einer Instanz des Date-Objekts kann ein Datumswert gespeichert werden. Es ist nicht nötig, die aktuelle Systemzeit zu verwenden. Erst ab JavaScript Version 1.3 sind Datumswerte vor dem 1. Januar 1970 möglich.
25.5.1 Allgemeines
new Date() //erstellt Datumsvariable mit lokaler Zeit
new Date(Millisekunden_seit_1970)
new Date(Jahr, Monat, Tag)
new Date(Jahr, Monat, Tag, Stunden, Minuten, Sekunden,
Millisekunden) //vor JS1.3
new Date(Jahr, Monat, Tag, Stunden, Minuten, Sekunden) //JS1.3
new Date(Datumsstring_im_GMT_Format)
Millisekunden_seit_1970 - Anzahl der seit dem 1. Januar 1970, Mitternacht, verstrichenen Millisekunden (in der Unix-Welt verbreitetes Datumsformat).
Jahr - Jahreszahl des Datumswertes.
Monat - Um eins verringerte Monatszahl des Datumswerts.
Tag - Tageszahl des Datumswertes.
Stunden - Stundenzahl des Datumswertes.
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
Datumsstring_im_GMT_Format - Zeichenkette der Form "Dec 24, 1999 12:34:56"; die Monatsabkürzungen müssen im amerikanischen Format angegeben werden.
25.5.2 Methoden
getDate
Tageszahl des Datumswertes.
getDay
Wochentag des Datumswertes. Dabei steht 0 für Sonntag, 1 für Montag, 6 für Samstag.
getFullYear
JS 1.2
Vollständige Jahreszahl; bei Datumswerten zwischen 1000 und 9999 also vierstellig; ab JavaScript 1.2.
getHours
Stundenzahl des Datumswertes.
getMilliseconds
Millisekundenzahl des Datumswertes.
getMinutes
Minutenzahl des Datumswertes.
getMonth
Um eins verringerte Monatszahl des Datumswertes (0 ist Januar, 11 ist Dezember).
getSeconds
Sekundenzahl des Datumswertes.
getTime
Anzahl der zwischen dem 1. Januar 1970, Mitternacht, und dem Datumswert verstrichenen Millisekunden. Wie im Kapitel »Erste Schritte« gezeigt wurde, kann man so einfach die Differenzen zwischen zwei Datumswerten berechnen.
getTimezoneOffset
Unterschied zwischen der lokalen Zeitzone und Greenwich Mean Time (GMT) in Minuten.
getUTCDate
JS 1.3
Tagesszahl des Datumswertes nach UTC (Universal Time Coordinate); ab JavaScript 1.3.
getUTCDay
JS 1.3
Wochentag des Datumswertes nach UTC; 0 ist Sonntag, 1 ist Montag, 6 ist Samstag; ab JavaScript 1.3.
getUTCFullYear
JS 1.3
Volle (also zwischen 1000 und 9999 vierstellige) Jahreszahl des Datumswerts nach UTC; ab JavaScript 1.3.
getUTCHours
JS 1.3
Stundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
getUTCMilliseconds
JS 1.3
Millisekundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
getUTCMinutes
JS 1.3
Minutenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
getUTCMonth
JS 1.3
Um eins verringerte Monatszahl des Datumswertes nach UTC; ab JavaScript 1.3.
getUTCSeconds
JS 1.3
Sekundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
getYear
Jahresszahl des Datumswertes; Vorgänger von getFullYear(). Die Plattformunterschiede werden im Kapitel »Erste Schritte« beschrieben.
parse
Anzahl der Millisekunden seit dem 1. Januar 1970, Mitternacht, und dem als Parameter übergebenen Datumswert.
Date.parse(Datum_im_GMT_Format)
setDate
Setzt die Tageszahl des Datumswertes.
setDate(Tag)
Tag - Tageszahl des Datumswertes.
setFullYear
JS 1.2
Setzt die vollständige Jahreszahl; bei Datumswerten zwischen 1000 und 9999 also vierstellig; ab JavaScript 1.2.
setFullYear(Jahr)
Jahr - Jahreszahl des Datumswertes
setHours
JS 1.0
Setzt die Stundenzahl des Datumswertes.
setHours(Stunden) //ab JS1.0
setHours(Stunden, Minuten, Sekunden, Millisekunden) //JS1.3
Stunden - Stundenzahl des Datumswertes.
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setMilliseconds
JS 1.3
Setzt die Millisekundenzahl des Datumswertes; ab JavaScript 1.3.
setMilliseconds(Millisekunden)
Millisekunden - Millisekundenzahl des Datumswertes.
setMinutes
JS 1.0
Setzt die Minutenzahl des Datumswertes.
setMinutes(Minuten) //ab JS1.0
setMinutes(Minuten, Sekunden, Millisekunden) //JS1.3
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setMonth
Setzt die Monatszahl des Datumswertes (0 ist Januar, 11 ist Dezember).
setMonth(Monat) //ab JS1.0
setMonth(Monat, Tag) //JS1.3
Monat - Um eins verringerte Monatszahl des Datumswerts.
Tag - Tageszahl des Datumswertes.
setSeconds
Setzt die Sekundenzahl des Datumswertes.
setSeconds(Sekunden) //ab JS1.0
setSeconds(Sekunden, Millisekunden) //JS1.3
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setTime
Setzt die Datumsvariable; der Parameter ist die Anzahl der zwischen dem 1. Januar 1970, Mitternacht, und dem Datumswert verstrichenen Millisekunden.
setTime(Millisekunden_seit_1970)
Millisekunden_seit_1970 - Anzahl der seit dem 1. Januar 1970, Mitternacht, verstrichenen Millisekunden (in der Unix-Welt verbreitetes Datumsformat).
setUTCDate
JS 1.3
Setzt die Tageszahl des Datumswertes nach UTC (Universal Time Coordinate); ab JavaScript 1.3.
setUTCDate(Tag)
Tag - Tageszahl des Datumswertes.
setUTCFullYear
JS 1.3
Setzt die volle (also zwischen 1000 und 9999 vierstellige) Jahreszahl des Datumswerts nach UTC; ab JavaScript 1.3.
setUTCFullYear(Jahr)
Jahr - Jahreszahl des Datumswertes.
setUTCHours
JS 1.3
Setzt die Stundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
setUTCHours(Stunden[, Minuten, Sekunden, Millisekunden])
Stunden - Stundenzahl des Datumswertes.
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setUTCMilliseconds
JS 1.3
Setzt die Millisekundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
setUTCMilliseconds(Millisekunden)
Millisekunden - Millisekundenzahl des Datumswertes.
setUTCMinutes
JS 1.3
Setzt die Minutenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
setUTCMinutes(Minuten[, Sekunden, Millisekunden])
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setUTCMonth
JS 1.3
Setzt den Monat des Datumswertes nach UTC (0 entspricht Januar, 11 entspricht Dezember); ab JavaScript 1.3.
setUTCMonth(Monat[, Tag])
Monat - Um Eins verringerte Monatszahl des Datumswerts.
Tag - Tageszahl des Datumswertes.
setUTCSeconds
JS 1.3
Setzt die Sekundenzahl des Datumswertes nach UTC; ab JavaScript 1.3.
setUTCSeconds(Sekunden[, Millisekunden])
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
setYear
Setzt die Jahreszahl des Datumswertes; Vorgänger von getFullYear(). Die Plattformunterschiede werden im Kapitel »Erste Schritte« beschrieben.
setYear(Jahr)
Jahr - Jahreszahl des Datumswertes.
toGMTString
Wandelt die Datumsvariable in eine GMT-Zeichenkette um; Vorgänger von toUTCString().
toLocaleString
Wandelt die Datumsvariable in eine Zeichenkette entsprechend den lokalen Gegebenheiten um. Diese Funktion bedient sich des Betriebssystems des Benutzers, um beispielsweise die Monatsnamen in der jeweiligen Sprache angeben zu können.
toString
JS 1.1
Wandelt die Datumsvariable in eine Zeichenkette um; ab JavaScript 1.1.
toUTCString
JS 1.3
Wandelt die Datumsvariable in eine Zeichenkette nach UTC um; ab JavaScript 1.3.
UTC
Gibt die Anzahl der Millisekunden in einer Datumsvariable seit dem 1. Januar 1970 an, entsprechend UTC (Universal Time Coordinate). Die Methode gibt kein Date-Objekt zurück, sondern nur eine Zahl. Sie wird eher als Methode des Date-Objekts aufgerufen und nicht als Methode einer Instanz des Date-Objekts.
Date.UTC(Jahr, Monat, Tag[, Stunden, Minuten, Sekunden])
//ab JS1.0
Date.UTC(Jahr, Monat, Tag[, Stunden, Minuten, Sekunden,
Millisekunden]) //ab JS1.3
Jahr - Jahreszahl des Datumswertes.
Monat - Um eins verringerte Monatszahl des Datumswerts.
Tag - Tageszahl des Datumswertes.
Stunden - Stundenzahl des Datumswertes.
Minuten - Minutenzahl des Datumswertes.
Sekunden - Sekundenzahl des Datumswertes.
Millisekunden - Millisekundenzahl des Datumswertes.
25.6 Das document-Objekt
JS 1.0
Ab JavaScript 1.0
Mit dem document-Objekt kann man auf die HTML-Seite zugreifen und auch HTML-Seiten erzeugen.
25.6.1 Allgemeines
HTML-Tag: <BODY>
25.6.2 Event-Handler
onClick
onDblClick (JS1.2)
onKeyDown (JS1.2)
onKeyPress (JS1.2)
onKeyUp (JS1.2)
onMouseDown (JS1.2)
onMouseUp (JS1.2)
25.6.3 Methoden
captureEvents
JS 1.2
Alle angegebenen Ereignisse werden abgefangen, siehe Kapitel »Events«; ab JavaScript 1.2, nur Netscape.
document.captureEvents(Ereignis1 | Ereignis2 | ... | EreignisN)
Ereignis1, Ereignis2, ..., EreignisN - Ereignisse, z. B. Event.MOUSEUP.
close
Beendet eine mit document.open() gestartete Ausgabe und bringt den Browser dazu, diese Ausgabe zu rendern.
document.open()
document.write("Read my lips")
document.close()
contextual
JS 1.2
Setzt Styles für Elemente innerhalb eines bestimmten Kontextes; ab JavaScript 1.2, nur Netscape.
contextual(Kontext1, Kontext2, ..., KontextN, Stil)
Kontext1, Kontext2, ..., KontextN - Ereignisse, z. B. Event.MOUSEUP.
Stil - Der zu ändernde Style
Aufgrund folgenden Codes werden alle fett gedruckten Zeichen innerhalb eines Absatzes grün angezeigt:
contextual(document.tags.P, document.tags.B).color = "green"
getSelection
JS 1.2
Gibt den gerade markierten Text des Dokuments zurück; ab JavaScript 1.2.
Diese Methode kann nicht von anderen Frames aus aufgerufen werden.
handleEvent
JS 1.2
Ruft den Event-Handler für ein bestimmtes Ereignis auf; ab JavaScript 1.2, nur Netscape.
document.handleEvent(Ereignis)
Ereignis - Ereignisobjekt.
Für Anwendungsbeispiele siehe Kapitel »Events«
open
Initiiert eine Ausgabe von HTML-Code mittels JavaScript; dies wird jedoch erst sichtbar, wenn die Ausgabe mit document.close() beendet wird. Bestehender HTML-Code wird dabei überschrieben, ein Anhängen ist also nicht möglich.
document.open() //ab JavaScript 1.0
document.open(MIME_Type) //Netscape, ab Internet Explorer 4
document.open(MIME_Type, ersetzen) //nur ab Netscape 4
MIME_Type - MIME-Typ der folgenden Daten. In der Regel ist das "text/html" (und der Internet Explorer läßt nur diesen Typ zu), aber möglich sind auch beispielsweise "image/gif" oder "plugIn".
ersetzen - Boolesche Variable, die angibt, ob das neue Dokument das alte in der History-Liste des Browsers ersetzen soll.
document.open()
document.write("Read my lips")
document.close()
releaseEvents
JS 1.2
Deaktiviert ein vorhergehendes captureEvents(); ab JavaScript 1.2, nur Netscape.
document.releaseEvents(Ereignis1 | Ereignis2 | ... | EreignisN)
Ereignis1, Ereignis2, ..., EreignisN - Ereignisse, z. B. Event.MOUSEUP.
Für Anwendungsbeispiele siehe Kapitel »Events«.
routeEvent
JS 1.2
Führt ein abgefangenes Ereignis dort aus, wofür es bestimmt war; ab JavaScript 1.2, nur Netscape.
document.routeEvent(Ereignis)
Ereignis - Ereignisobjekt.
Für Anwendungsbeispiele siehe Kapitel »Events«.
write
Gibt HTML-Code mittels JavaScript aus; dies wird jedoch erst sichtbar, wenn die Ausgabe mit document.close() beendet wird. Ein vorhergehendes document.open() ist optional.
document.write(Text)
Text - Auszugebender Text.
document.open()
document.write("Read my lips")
document.close()
writeln
Gibt HTML-Code mittels JavaScript aus und fügt - im Gegensatz zu document.write() - einen Zeilenvorschub an.
document.writeln([Text])
Text - Auszugebender Text.
Wird kein Parameter angegeben, so wird eine Leerzeile ausgegeben. Diese ist jedoch bei HTML-Dokumenten im Allgemeinen nicht sichtbar.
document.open()
document.write("Read my lips")
document.close()
25.6.4 Eigenschaften
alinkColor
Farbe eines aktiven Links (während er angeklickt wird, bevor der Benutzer die Maustaste wieder losläßt). HTML-Äquivalent: <BODY ALINK="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
document.alinkColor = "red"
document.alinkColor = "#ff0000"
all
Ermöglicht den Zugriff auf Style-Eigenschaften; ab Internet Explorer 4. Siehe Kapitel »DHTML II«
anchors
Array, das alle Textmarken im Dokument enthält. Siehe Anchor-Objekt.
applets
Array, das alle Applets im Dokument enthält. Zu Interaktion mit Java siehe Kapitel »Java«.
bgColor
Hintergrundfarbe des Dokuments. HTML-Äquivalent: <BODY BGCOLOR= "Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
document.bgColor = "white"
document.bgColor = "#ffffff"
classes
JS 1.2
Erzeugt eine Style-Sheet-Klasse, die im HTML-Code angesprochen werden kann; ab JavaScript 1.2, nur Netscape.
<STYLE TYPE="text/javascript">
classes.GalileoBlau.all.color = "blue"
</STYLE>
<SCRIPT LANGUAGE="JavaScript">
document.classes.GalileoBlau.all.color = "blue"
</SCRIPT>
cookie
Zeichenkette, die alle Cookies enthält, auf die von der HTML-Seite aus zugegriffen werden darf. Für Anwendungen siehe Kapitel »Cookies«.
domain
JS 1.1
Enthält den Domainnamen des Servers, auf dem die aktuelle HTML-Seite liegt; ab JavaScript 1.1.
Aufgrund von Sicherheitsbestimmungen hat man von JavaScript aus von einem Dokument mit dem Domainnamen www.server.de keinen Zugriff auf gewisse Objekte in einem anderen Frame mit dem Domainnamen www2.server.de; hier sollte man document.domain auf server.de setzen, damit der Zugriff wieder funktioniert.
embeds
JS 1.1
Array, das alle mit dem <EMBED>-Tag eingefügten Daten enthält (bzw. zumindest deren Anzahl); ab JavaScript 1.1.
alert("Dieses Dokument enthält "
+ document.embeds.length + " eingebettete Dateien")
fgColor
(Vordergrund-)farbe des Dokuments. HTML-Äquivalent: <BODY COLOR= "Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
document.fgColor = "black"
document.fgColor = "#000000"
forms
Array, das alle Formulare in einem HTML-Dokument enthält. Siehe Kapitel »Formulare I«.
document.forms[Index]
document.forms["FormularName"]
document.FormularName
Index - Nummer des Formulars im Dokument (bei mehreren Formularen); die Zählung beginnt bei 0.
FormularName - NAME-Attribut des Formulars.
height
JS 1.2
Höhe eines Dokuments (in Pixeln); ab JavaScript 1.2
ids
JS 1.2
Erzeugt einen Style-Sheet-Identifikator; ab JavaScript 1.2.
Siehe Kapitel »DHTML I«.
images
JS 1.1
Array, das alle Grafiken innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.1 (und Internet Explorer 3 für Macintosh).
document.images[Index]
document.images["BildName"]
document.BildName
Index - Nummer der Grafik im Dokument; die Zählung beginnt bei 0.
BildName - NAME-Attribut der Grafik.
Siehe Kapitel »Images«
lastModified
Datum der letzten Änderung der Datei als Zeichenkette.
Dieser Wert wird aus dem HTTP-Header gewonnen, und die Daten darin werden zumeist vom Server aus dem Änderungsdatum der Datei auf dem Server bestimmt.
document.write("Letzte Änderung: "+document.lastModified)
layers
JS 1.2
Array, das alle Layer innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.2, nur Netscape.
document.layers[Index]
document.layers["LayerName"]
document.LayerName
Index - Nummer des Layers im Dokument; Zählung beginnt bei 0.
LayerName - NAME-Attribut des Layers.
siehe Kapitel »DHTML I«
linkColor
Linkfarbe des Dokuments. HTML-Äquivalent: <BODY LINK="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
document.linkColor = "blue"
document.linkColor = "#0000ff"
links
Array, das alle Hyperlinks innerhalb eines HTML-Dokuments enthält.
document.links[Index]
Index - Nummer des Links im Dokument; Zählung beginnt bei 0.
siehe Link-Objekt.
plugins
JS 1.1
Array, das alle Plugins innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.1, nur Netscape.
siehe Kapitel »Musik«
referrer
URL der Seite, von der aus die aktuelle Seite aufgerufen wurde; entspricht der Umgebungsvariablen HTTP_REFERER.
document.write("Sie kommen von "+document.referer)
Bei manchen Versionen des Internet Explorers 3 und 4 ist diese Eigenschaft falsch implementiert (die URL der aktuellen Seite wird zurückgegeben).
tags
JS 1.2
Erzeugt eine Style-Sheet-Klasse für einen gewissen Tag, die im HTML-Code angesprochen werden kann; ab JavaScript 1.2, nur Netscape.
Der folgende Code sorgt dafür, dass alle Level-3-Überschriften in blauer Farbe dargestellt werden:
document.tags.H3.all.color = "blue"
title
Titel des Dokuments; HTML-Äquivalent: <TITLE>Titel</TITLE>; kein Schreibzugriff.
URL
JS 1.1
Die komplette URL des aktuellen Dokuments als Zeichenkette; ab JavaScript 1.1. Ersatz für document.location, nicht zu verwechseln mit window.location.
vlinkColor
Farbe für besuchte Links des Dokuments. HTML-Äquivalent: <BODY VLINK="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
document.vlinkColor = "red"
document.vlinkColor = "#ff0000"
width
JS 1.2
Breite des Dokuments in Pixeln; ab JavaScript 1.2.
25.7 Das event-Objekt
Ab Netscape Navigator 4 und Internet Explorer 4; unterschiedliche Implementierung; siehe Kapitel »Events«
25.7.1 Netscape-Eigenschaften
data
Array, das die URLs als Zeichenkette enthält, die bei einer Drag&Drop-Operation (dragdrop-Ereignis) auf dem Browserfenster »fallengelassen« werden. Zugriff nur mit UniversalBrowserRead bzw. UniversalBrowserWrite.
height
Höhe des Fensters oder Frames.
layerX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Layers, in dem das Ereignis eingetreten ist.
layerY
y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Layers, in dem das Ereignis eingetreten ist.
modifiers
Sondertasten, die beim Eintreten des Ereignisses gedrückt waren ((Strg), (Alt), (Shift), (Meta)).
pageX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Dokuments.
pageY
y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Dokuments.
screenX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Bildschirms.
screenY
y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Bildschirms.
target
Referenz auf das Objekt, für das das Ereignis bestimmt war.
type
Art des Ereignisses als Zeichenkette (z. B. "click").
which
ASCII-Code der gedrückten Tastaturtaste bzw. Nummer der gedrückten Maustaste.
width
Breite des Fensters oder Frames.
x
Entspricht layerX.
y
Entspricht layerY.
25.7.2 Internet Explorer-Eigenschaften
altKey
Boolescher Wert, der angibt, ob die (Alt)-Taste beim Eintreten des Ereignisses gedrückt war.
button
Nummer der gedrückten Maustaste; Zählung beginnt bei 0.
cancelBubble
Boolescher Wert, der angibt, ob das Event-Bubbling deaktiviert werden soll.
clientX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Browser-Fensters.
clientY
Y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Browser-Fensters.
ctrlKey
Boolescher Wert, der angibt, ob die (Strg)-Taste beim Eintreten des Ereignisses gedrückt war.
fromElement
Nur bei mouseover/mouseout: Referenz auf das Objekt, von dem der Mauszeiger kommt.
keyCode
Unicode-Wert der Taste, die zum Eintreten des Ereignisses (z. B. keydown) geführt hat.
offsetX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Containers, in dem das Ereignis eingetreten ist.
offsetY
y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Containers, in dem das Ereignis eingetreten ist.
reason
Gibt das Ergebnis der Datenübertragung bei der Ereignisbehandlung zurück. 0 steht für erfolgreiche Übertragung, 1 für Abbruch der Übertragung und 2 für Übertragungsfehler.
returnValue
Wert, den der Event-Handler zurückgibt. Ist dieser false, so wird die Aktion, die das Ereignis hervorgerufen hat, abgebrochen (beispielsweise der Formularversand).
shiftKey
Boolescher Wert, der angibt, ob die (Shift)-Taste beim Eintreten des Ereignisses gedrückt war.
srcElement
Referenz auf das Objekt, für das das Ereignis bestimmt war.
screenX
x-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Bildschirms.
screenY
y-Koordinate des Mauszeigers relativ zur linken oberen Ecke des Bildschirms.
toElement
Nur bei mouseover/mouseout: Referenz auf das Objekt, zu dem der Mauszeiger geht.
type
Art des Ereignisses als Zeichenkette (z. B. "click").
x
x-Koordinate des Mauszeigers relativ zu dem CSS-positionierten Element, in dem das Ereignis ausgelöst worden ist.
x
y-Koordinate des Mauszeigers relativ zu dem CSS-positionierten Element, in dem das Ereignis ausgelöst worden ist.
25.8 Das FileUpload-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird ein Datei-Element in einem Formular in JavaScript abgebildet; das Objekt ist ein Element des Form-Objekts.
25.8.1 Allgemeines
HTML-Tag: <INPUT TYPE="FILE">
document.forms[Index].elements[index]
document.FormularName.FileUploadName
Index - Index im jeweiligen Array.
FileUploadName - NAME-Attribut des Datei-Elements.
25.8.2 Event-Handler
onBlur (JS1.1)
onChange
onFocus (JS1.1)
25.8.3 Methoden
blur
Entfernt den Fokus von dem Datei-Element.
click
Simuliert das Anklicken des Datei-Elements.
focus
Gibt dem Datei-Element den Fokus.
select
Wählt das Eingabefeld des Datei-Elements aus.
25.8.4 Eigenschaften
form
Referenz auf das Formular, das das Datei-Element enthält.
name
NAME-Attribut des Datei-Elements
type
Zeichenkette mit dem Wert "file"; ab JavaScript 1.1
value
VALUE-Attribut des Datei-Elements; kann i. d. R. nicht mit JavaScript gesetzt werden.
25.9 Das Form-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird ein Formular in JavaScript abgebildet; das Objekt ist ein Element des document-Objekts
25.9.1 Allgemeines
HTML-Tag: <FORM>
document.forms[Index]
document.FormularName
Index - Index im Array.
Formularname - NAME-Attribut des Formulars.
25.9.2 Event-Handler
onReset (JS1.1)
onSubmit
25.9.3 Methoden
reset
JS 1.1
Setzt alle Formularwerte auf die Standardwerte zurück; ab JavaScript 1.1.
<A HREF="document.forms[0].reset()">Formular zurücksetzen</A>
Das Formular muss keine Reset-Schaltfläche enthalten, damit das funktioniert. HTML-Äquivalent: Mausklick auf <INPUT TYPE="RESET">.
submit
Versendet das Formular; HTML-Äquivalent: Mausklick auf <INPUT TYPE="SUBMIT">.
<A HREF="document.forms[0].submit()">Formular versenden</A>
Ein Formular kann auch per Email (mailto:) oder via Usenet (news:/snews:) versandt werden, wodurch aber die E-Mail-Adresse des Versenders bekannt werden würde. Ab Netscape Navigator 3 bzw. Internet Explorer 4 kommt eine Warnmeldung, wenn der Benutzer (mit einer Submit-Schaltfläche) ein Formular an eine solche URL verschicken will. Seit JavaScript 1.1 ist es nicht mehr möglich, ein solches Formular mit submit() zu versenden.
25.9.4 Eigenschaften
action
Die URL der Seite oder des Skripts, an die das Formular verschickt wird; HTML-Äquivalent: <FORM ACTION="Seite_oder_Skript">.
elements
Array mit allen Formularelementen. Die einzelnen Elemente dieses Arrays sind vom jeweiligen Typ des Formularelements, beispielsweise Checkbox oder FileUpload.
alert("Das Formular enthält
"+document.forms[0].elements.length+" Elemente")
encoding
Die MIME-Methode, mit der die Formulardaten verschickt werden; HTML-Äquivalent: <FORM ENCTYPE="MIME_Methode">.
length
Anzahl der Formularelemente; äquivalent zu elements.length.
method
Versendemethode; entweder "post" oder "get".
name
NAME-Attribut des Formulars
target
Bezeichner für das Fenster oder den Frame, in dem die Ausgaben der Seite, an die das Formular übergeben wird, erscheinen. HTML-Äquivalent: <FORM TARGET="Bezeichner">.
document.forms[0].target = "_blank"
25.10 Das Frame-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird ein Frame in JavaScript abgebildet; das Objekt ist ein Element des window-Objekts. Von der Handhabung verhält sich ein Frame genauso wie ein window-Objekt, weswegen auf diesen Teil der Referenz verwiesen wird.
25.11 Das Hidden-Objekt
JS 1.0
Ab JavaScript 1.0
Hiermit wird ein verstecktes Formularfeld in JavaScript abgebildet; das Objekt ist ein Element des Form-Objekts.
25.11.1 Allgemeines
HTML-Tag: <INPUT TYPE="HIDDEN">
document.forms[Index].elements[Index]
document.FormularName.FeldName
Index - Index im jeweiligen Array.
FeldName - NAME-Attribut des versteckten Feldes.
| 
